home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / 172anew.zip / RDB.DOC < prev    next >
Text File  |  1989-05-23  |  6KB  |  189 lines
  1. Documentation for Remote Data Base
  2. by Ken Goosens
  3. 24 May 1989
  4.  
  5. Remote Data Base (RDB) is a new, built in facility in RBBS 17.2A.
  6. It gives the sysop the ability to:
  7.  
  8. o   set up unlimited numbers of named data bases
  9.  
  10. o   set up menus to interact with the user
  11.  
  12. o   prompt users for data
  13.  
  14. o   use Metavariables - both work variables and SmartText variables.
  15.  
  16. o   store user's answers in work variables.   Any subfield in a
  17.     work variable can be referenced.
  18.  
  19. o   display, or store all metavariables
  20.  
  21. o   process commands conditionally
  22.  
  23. o   save Metavariables to file thru templates, allowing data to
  24.     be stored in virtually any format desired
  25.  
  26. o   retrieve data into templates for display.
  27.  
  28. o   do full screen data entry
  29.  
  30.  
  31.                   Full Screen Processing
  32.  
  33. RBBS now supports "full screen" questionnaires and macros, though this
  34. takes some work on the sysop's part to set up.  Essentially you use
  35. ANSI screen commands, transmit a template which clears the
  36. screen at the top, and then transmit the data into the template.
  37. The "full screen" is not the complete full screen in which the caller
  38. can use keys like tab and arrows to move around.  It is full screen
  39. in the sense that the caller sees all the data that is to be enterred
  40. and the cursor moves from field to field.
  41.  
  42.  
  43.                    Examples of Applications
  44.  
  45. For Sale - ask user item, price, who to contact, telephone #.
  46.     Callers can add items, or view list of items.
  47.  
  48. BBS lists - Callers can view data base, or add BBS's where
  49.     asked for name, numbers, profile of features.  No longer do
  50.     BBS ads have to be left in messages.   Can have informative,
  51.     standardized profile that makes BBS comparision meaningful.
  52.  
  53. BIO - ask users for a profile of themselves so others can know
  54.     who they are.
  55.  
  56. VOTING - can collect nominations say for best GIF files.  No
  57.     way yet to force a caller to vote only once.
  58.  
  59.  
  60.                 Details of an Application
  61.  
  62. This application manages a data base of who is willing to help
  63. with RBBS by topic.   It is controlled at a high level by the
  64. following questionnaire.
  65.  
  66. C:DUMMY.DAT,4
  67. * This questionnaire is for finding help with RBBS by topic.
  68. * Please register yourself if you
  69. *   o  are willing to help others, and
  70. *   o  know enough about a topic to help
  71. *
  72. * Examples of topics people need help with:
  73. *   Desqview       Modem models (HST, Everex, USR Internal, etc.)
  74. *   PC-Slaves      Protocols     Conferences    FMS
  75. *   Doors          DoubleDos     Subboards      PUI
  76. *   Questionnaires 10-Net        Marcos         Uploads
  77. *   MU-Purge       File maint.   Personal dwld  Caller Analysis
  78. *
  79. :-[prompt]-
  80. T
  81. ? V)iew database, E)nter new data, Q)uit (V,E,Q)
  82. =V-[view]-=E-[add]-=Q-[quit]-= -[prompt]-
  83. :-[view]-
  84. M C:\RBBS\VIEWHELP.MCR
  85. >-[prompt]-
  86. :-[quit]-
  87. @
  88. :-[add]-
  89. *                  703-978-6360
  90. ?1 BBS data number
  91. *                                   703-978-4339
  92. ?2 Voice # (evening, 0 not to give)
  93. * You can specify as many topics as desired, one at a time.
  94. *
  95. :-[topic]-
  96. ?3 RBBS topic you will help others with, or Q)uit
  97. =Q-[prompt]-= -[addrec]-
  98. :-[addrec]-
  99. * -Topic-         - Data # -      - Voice # -   Last Name       First Name
  100. */FL[3]              [1]             [2]            {LN             {FN          
  101. T
  102. ?Really add this record (Y,N)
  103. =Y-[really]-=N-[topic]-= -[addrec]-
  104. :-[really]-
  105. M C:\RBBS\ADDHELP.MCR
  106. >-[topic]-
  107.  
  108. Two macros are used by this questionnaire:  VIEWHELP.MCR for displaying
  109. the data base, and ADDHELP.MCR for appending new data to the data base.
  110. For more documentation on macro commands, see MACROS.DOC.
  111. VIEWHELP.MCR contains
  112.  
  113. 5
  114. {*1 -Topic-         - Data # -      - Voice # -   Last Name       First Name
  115. {*F RBBSHELP.DAT
  116. {ST
  117.  
  118. ADDHELP.MCR contains
  119.  
  120. 5
  121. {>> RBBSHELP.DAT /FL
  122. [3]              [1]             [2]            {LN             {FN          
  123. {END
  124. {ST
  125.  
  126.                     A Full Screen Application
  127.  
  128. Full screen is available only in a color graphics version of questionnaires
  129. and macros.   A long application for collecting BBS information is given
  130. in these following files:
  131.  
  132. REGRBBS.DEF  - Questionnaire driver, TTY version
  133. REGRBBSC.DEF - Color graphics version of questionnaire driver
  134. VUNRBBS.MCR  - View data base macro, TTY version
  135. VUNRBBSC.MCR - View data base macro, Color graphics version
  136. SVRBBS.MCR   - Macro to save data to a comma separated data file
  137.  
  138.  
  139.              Hints a Building Your own Applications
  140.  
  141. Generally you will have
  142.  
  143. o    a questionnaire driver that gives caller option to exit, view
  144.      database, or Enter new data.
  145.  
  146. o    a macro to retrieve data from file to a form
  147.  
  148. o    a macro to save data in a data base format.
  149.  
  150. o    a data entry routine in the questionnaire.
  151.  
  152. Full screen is more complicated that TTY.  Generally, you will want
  153.  
  154. o    to paint a template with all everything but the data values,
  155.      such as row and column labels and titles.
  156.  
  157. o    to clear out the existing values in a form and then put in
  158.      the new values.
  159.  
  160. You transmit only the changes to a screen rather than retransmitting
  161. the entire screen when only a part changes.
  162.  
  163. You use ANSI commands to control the screen.   Where [ESC] stands
  164. for the one-character Escape (ascii 27), the most useful ANSI commands
  165. to know are:
  166.  
  167. [ESC][2J   -  clear the screen.
  168.  
  169. [ESC][K    -  clear from current cursor postion to end of line.  Cursor
  170.               position after clearing is same as before.
  171.  
  172. [ESC][X;Yf -  position the cursor on row x and column Y.  E.g.
  173.               "[ESC][5;10f" positions on column 10 of row 5.
  174.  
  175. Case is signficant in ANSI commands, so beware that "[ESC][k" will NOT
  176. clear to end of line, and "[ESC][1;7F" will not position the cursor.
  177.  
  178. You can use ANSI commands to reverse the video and change blinking and
  179. set color.   An easy way consistent with RBBS to set colors is to use
  180. the SmartText variables C0, C1, ..., C4, where 1-4 are the colors set
  181. on config and C0 is "emphasis off" that restores normal text color
  182. perference of the caller.  E.g.
  183.  
  184. [ESC][2J{C1[ESC]1;15fSample Title-{C0  [1]
  185.  
  186. clears the screen, sets color to 1, positions on line 1, column 15,
  187. prints "Sample Title-", sets color to caller's text preference, prints
  188. 2 spaces, then prints value of work variable 1.
  189.